Installation und Updates
Es stehen drei Installationsmöglichkeiten zur Auswahl:
-
Installation per NPM Package Manager
Mit dem NPM Package Manager kannst du adaptor:ex einfach über die Kommandozeile auf jedem gängigen Betriebssystem installieren und als NPM Anwendung ausführen.
Wir empfehlen die Installation per NPM Package Manager wenn du adaptor:ex lokal auf deinem Rechner oder in einem internen Netzwerk nutzen willst.
Eine lokale Installation erlaubt es dir die Anschlüsse an deinem Rechner zu nutzen. Z.B. den Seriellen Anschluss per USB oder eine Soundkarte.
-
Im besonderen für eine Server Installation empfehlen wir die Installation in einem Docker Container.
Du kannst unser Docker Compose File nutzen um ein umfangreiches und stabiles Setup mit unabhängiger Server und Client Anwendung und MongoDB Integration zu erstellen.
Das Server Setup Tutorial hilft dir dabei adaptor:ex mit Docker und Docker Compose auf einem externen Server zu installieren, zu sichern und für alle, die an deinem Projekt mitarbeiten, zugänglich zu machen.
-
Lade den adaptor:ex Quellcode herunter und nutze NPM um die Server Anwendung und den Client unabhängig voneinander zu installieren und auszuführen.
Eine Installation ausgehend vom Quellcode erlaubt es dir Änderungen an der Software vorzunehmen.
Wir empfehlen die Installation vom Quellcode wenn du etwas am Code anpassen oder an der Entwicklung von adaptor:ex mitwirken willst.
Hinweise
Command Line Terminal
Um adaptor:ex zu installieren musst du derzeit die Kommandozeile deines Betriebssystems nutzen. Unter macOS suche das Programm "Terminal". Unter Linux findest du das Terminal unter der Tastenkombination [ctrl] + [alt] + [T]. Unter windows suche die Anwendung "Eingabeaufforderung" bzw. "Commandline".
Konfiguration
Die adaptor:ex Server Anwendung bietet verschiedene Möglichkeiten um deine Installation anzupassen. In der Readme des adaptor:Ex Server Code repositories sind alle Konfigurationsmöglichkeiten beschrieben.
Einige Funktionen des adaptor:ex Server können zudem über die Kommandozeile gesteuert werden: Commands
Multi User Server Setup
Wirf einen Blick in das Server Setup Tutorial um adaptor:ex mit Docker und Docker Compose auf einem externen Server zu installieren. Hier findest du auch heraus, wie du den Internetzugriff auf adaptor:ex sichern und für alle, die an deinem Projekt mitarbeiten, zugänglich machen kannst.
Updates
Wir werden in der Zukunft häufig Fehler beheben, Dinge (hoffentlich) verbessern und neue Features hinzufügen. Führe hin und wieder ein Update via NPM oder Docker durch, um auf dem neuesten Stand zu bleiben.
Hilfe bekommen
Melde dich bei uns, wenn du Schwierigkeiten hast, adaptor:ex zu installieren. Schreib uns an tech@machinaex.de oder schau auf unserem Discord Kanal vorbei.
Installieren mit NPM
Bevor Du mit der Installation von adaptor:ex fortfahren kannst, brauchst Du die aktuelle Version von NodeJS. Die nötigen Installationsdateien für dein Betriebssystem findest Du hier.
Sobald Du NodeJS installiert hast, öffne deine Konsole bzw. das Terminal und führe in der Kommandozeile die Installation mit npm aus
Auf macOS und Linux
Auf WindowsWenn die Installation erfolgreich war, starte adaptor:ex mit dem Kommando
Möglichkeiten adaptor:ex zu Konfigurieren findest du in der adaptor:ex server readme
Um den adaptor:ex server wieder zu beenden benutze die Tastenkombination [Strg] + [C] (windows/linux) bzw. [Cmd] + [C] (MacOS), oder gib quit in die Konsole ein.
Updates mit NPM
Lade dir die neueste Version von adaptor:ex herunter indem du die obige Installation wiederholst.
Mit npm outdated -g kannst du überprüfen ob eine neue Version zur Verfügung steht.
Installieren mit Docker
Lade Docker für dein Betriebsystem herunter und folge den Installationsanweisungen auf https://docs.docker.com/get-docker/
Erstelle einen neuen Ordner in dem du adaptor:ex installieren willst.
Öffne deine Kommandozeile, wechsle mit dem cd command in das adaptor:ex verzeichnis und lade die adaptor:ex docker-compose Datei herunter:
curl -o docker-compose.yml https://gitlab.com/machina_ex/adaptor_ex/adaptor_ex_server/-/raw/main/docker-compose.yml
Führe die Docker Compose Datei aus:
adaptor:ex Server, Client, Datenbank und Plugin Erweiterungen werden heruntergeladen und installiert.
In der adaptor:ex server readme kannst du mehr über die Konfiguration von adaptor:ex erfahren.
Updates mit Docker
Um die adaptor:ex Docker installation zu aktualisieren wechsle in das adaptor:ex Verzeichnis. Dort führe folgende Kommandos aus:
und anschließend
Installieren von Source mit NPM
Bevor Du mit der Installation von adaptor:ex fortfahren kannst, brauchst Du die aktuelle Version von NodeJS. Die nötigen Installatiosdateien für dein Betriebssystem findest Du hier.
Hole dir adaptor:ex Server und Client:
Server
Klone oder lade dir das aktuelle GitLab-Repository des adaptor:ex Servers hier herunter: https://gitlab.com/machina_ex/adaptor_ex/adaptor_ex_server
Client
Klone oder lade dir das aktuelle GitLab-Repository des adaptor:ex Clients hier herunter: https://gitlab.com/machina_ex/adaptor_ex/adaptor_ex_client
Jetzt kannst du den Server und den Client mit NPM lokal installieren.
Wechsel im Terminal (der Konsole) in das Verzeichnis in das du den Server oder Client geladen oder geklont hast.
bzw.
Wenn du in dem richtigen Verzeichnis bist führe den folgenden Befehl aus:
Wenn die Installation erfolgreich war, starte den adaptor:ex Server im entsprechenden Verzeichnis mit dem Kommando
Starte anschließend, in einer separaten Commando Zeile, den adaptor:ex Client im entsprechenden Verzeichnis mit dem Kommando
Updates mit git
Lade dir die neueste Version von adaptor:ex server und client herunter indem du im jeweiligen Verzeichnis das Git Repository mit folgendem Befehl updates
Starte den adaptor server und client anschließend neu.